home *** CD-ROM | disk | FTP | other *** search
/ Computer Shopper 242 / Issue 242 - April 2008 - DPCS0408DVD.ISO / Software Money Savers / VirtualDub / Source / VirtualDub-1.7.7-src.7z / src / helpfile / source / root.lina < prev    next >
Encoding:
Text File  |  2006-11-04  |  11.5 KB  |  249 lines
  1. <root>
  2.     <lina:set-option name="output-dir" target="../../out/Helpfile"/>
  3.     <lina:set-option name="link-truncate" baseurl="" notruncate/>
  4.  
  5.     <lina:fireball src="source/layout.css" dst="layout.css"/>
  6.  
  7.     <lina:macro name="create">
  8.         <lina:tag name="lina:htmlhelp-addfile">
  9.             <lina:attrib name="file"><lina:arg name="file"/></lina:attrib>
  10.         </lina:tag>
  11.         <lina:tag name="lina:write">
  12.             <lina:attrib name="file"><lina:arg name="file"/></lina:attrib>
  13.             <html>
  14.                 <head>
  15.                     <link rel="stylesheet" href="layout.css" type="text/css"/>
  16.                     <title>
  17.                         <lina:if-not-arg name="title">VirtualDub help</lina:if-not-arg><lina:if-arg name="title"><lina:arg name="title"/></lina:if-arg>
  18.                     </title>
  19.                 </head>
  20.                 <body>
  21.                     <div class="pagetop">
  22.                                     VirtualDub help<lina:if-arg name="title"> - <lina:arg name="title"/></lina:if-arg>
  23.                     </div><div class="body">
  24.                         <lina:body/>
  25.                     </div>
  26.                 </body>
  27.             </html>
  28.         </lina:tag>
  29.     </lina:macro>
  30.  
  31.     <lina:create file="index.html">
  32.         <p>
  33.             Welcome to the new helpfile for VirtualDub 1.5+.
  34.         </p>
  35.  
  36.         <p>
  37.             The old help file used to have some general tips on how to create video, but I've come
  38.             to the conclusion that such a help file is too much effort to maintain and that my efforts
  39.             in this area are better spent explaining what the options do rather than how to use them.
  40.             So, currently, this help file currently consists of comprehensive explanations of what
  41.             various settings dialogs in VirtualDub do.
  42.         </p>
  43.     </lina:create>
  44.  
  45.     <lina:macro name="note">
  46.         <table border="0" cellpadding="0" cellspacing="0" style="padding: 1px; margin: 16px 0px">
  47.             <tr>
  48.                 <td style="padding-right: 20px"><span style="border: 0 solid red; border-bottom-width: 1px">Note</span></td>
  49.                 <td width="*"><lina:body/></td>
  50.             </tr>
  51.         </table>
  52.     </lina:macro>
  53.  
  54.     <lina:macro name="dt">
  55.         <dt><span class="dtitle"><lina:body/></span></dt>
  56.     </lina:macro>
  57.  
  58.     <lina:macro name="image">
  59.         <lina:tag name="lina:fireball">
  60.             <lina:attrib name="src">source/<lina:arg name="src"/></lina:attrib>
  61.             <lina:attrib name="dst"><lina:arg name="src"/></lina:attrib>
  62.         </lina:tag>
  63.         <lina:tag name="img">
  64.             <lina:attrib name="src"><lina:arg name="src"/></lina:attrib>
  65.             <lina:if-arg name="width"><lina:attrib name="width"><lina:arg name="width"/></lina:attrib></lina:if-arg>
  66.             <lina:if-arg name="height"><lina:attrib name="height"><lina:arg name="height"/></lina:attrib></lina:if-arg>
  67.         </lina:tag>
  68.     </lina:macro>
  69.  
  70.  
  71.     <lina:include file="source/dialogs.lina"/>
  72.     <lina:include file="source/videofilters.lina"/>
  73.     <lina:include file="source/audiofilters.lina"/>
  74.     <lina:include file="source/crash.lina"/>
  75.     <lina:include file="source/capture.lina"/>
  76.     <lina:include file="source/render.lina"/>
  77.     <lina:include file="source/fxvideo.lina"/>
  78.     <lina:include file="source/htmltoc.lina"/>
  79.     <lina:include file="source/avi.lina"/>
  80.  
  81.  
  82.     <lina:create file="capwarn.html">
  83.         Below are listed some issues you may have with video capture drivers.  VirtualDub detects these
  84.         drivers by name and/or filename, and the particular version you have installed may not have
  85.         the problems listed.  These are intended as notices for behavior to watch out for.
  86.  
  87.         <h2>miro/Pinnacle capture driver issues</h2>
  88.         <p>
  89.             You may experience abnormally slow UI response with this driver when using overlay display
  90.             mode and dialogs or menus overlap the display window.  Switching to Preview mode will avoid
  91.             this.  Also, under <em>Preferences</em>, the <em>Disable preview/overlay for menus and dialogs</em>
  92.             option may be helpful, as it attempts to automatically disable video as appropriate.
  93.         </p>
  94.  
  95.         <h2>Zoran capture driver issues</h2>
  96.         <p>
  97.             Some versions of this driver round off frame rates to the nearest millisecond period.  For instance,
  98.             specifying 15 fps as the desired frame rate may result in an actual capture rate of 14.925 fps (67 ms/frame)
  99.             or 15.152 fps (66 ms/frame).  The capture settings dialog has a "round" button to help you
  100.             specify an attainable frame rate, avoiding frame drops that would otherwise occur due to the discrepancy.
  101.             The Quick FPS menu at the bottom right of the window also has frame rates pre-rounded to milliseconds
  102.             for convenience.
  103.         </p>
  104.  
  105.         <h2>Brooktree/Conexant BT8x8 driver issues</h2>
  106.         <p>
  107.             The BT8x8 series of video capture chips can't capture the same video data to both memory and
  108.             the display at the same time.  As a result, attempting to capture both fields (height >240 NTSC or >288 PAL)
  109.             while Overlay display is enabled may result in the overlay stopping or strange errors appearing.
  110.             Use Preview mode or disable display in order to capture both fields.
  111.         </p>
  112.         <p>
  113.             Note that this may not apply to you if the chip is integrated into your video card.
  114.         </p>
  115.     </lina:create>
  116.     
  117.     <lina:create file="non-admin.html" title="Running VirtualDub as non-administrator">
  118.         <p>
  119.             VirtualDub can be run from a Windows user account with limited privileges, but there are some
  120.             limitations to be aware of.
  121.         </p>
  122.         <h2>File layout</h2>
  123.         <p>
  124.             Currently, VirtualDub stores batch queue information in a writable file called VirtualDub.jobs, placed next to
  125.             the program file (VirtualDub.exe). If VirtualDub is located in a folder that is not writable by the current user,
  126.             the job queue will not be saved between sessions.
  127.         </p>
  128.         <h2>Operations that require elevated privileges</h2>
  129.         <p>
  130.             The "shutdown when finished" option in the Job Control dialog requires shutdown privileges.
  131.         </p>
  132.         <p>
  133.             Preallocating disk space in capture mode works differently depending on whether the "Manage Volume" privilege is available, which
  134.             is normally granted only to administrators. If this privilege is available, VirtualDub preallocates space very
  135.             quickly; if it is not available, then capture files can still be preallocated, but Windows will zero the entire file, which can
  136.             take some time.
  137.         </p>
  138.         <lina:note>
  139.             The turbo preallocation mode causes the capture file to contain whatever was previously on the disk, which may cause the contents
  140.             of previously deleted files to reappear until the capture finishes and the unused space is re-deleted. If you are on a shared
  141.             system, you may want to protect the directory with the capture file so that non-administrators cannot read the old data in the
  142.             capture file.
  143.         </lina:note>
  144.     </lina:create>
  145.     
  146.     <lina:create file="cmdline.html" title="Command-line operation">
  147.         <p>
  148.             It is possible to invoke VirtualDub in the background and control it in a limited fashion from other
  149.             programs.
  150.         </p>
  151.         
  152.         <h2>VirtualDub command-line options</h2>
  153.         <p>
  154.             First, specifying a filename on the command line causes VirtualDub to load it as a video file on startup.
  155.             This is the same as loading it using <em>File > Open video file...</em>, with the default autodetect-format
  156.             mode.
  157.         </p>
  158.         <blockquote><pre>virtualdub "My video.avi"</pre></blockquote>
  159.         <p>
  160.             The /s flag runs a script; its one argument is the filename of the script to run. Configuration files (.vcf) are
  161.             scripts. Note that the order of arguments is significant; some settings, such as the edit list, are reset when
  162.             a video file is opened.
  163.         </p>
  164.         <blockquote><pre>virtualdub /s mySettings.vcf myVideo.avi</pre></blockquote>
  165.         <p>
  166.             When /x is used, VirtualDub exits when it runs through the whole command line. Its position relative to other
  167.             options does not matter.
  168.         </p>
  169.         <blockquote><pre>virtualdub myVideo.avi /s reprocess.script /x</pre></blockquote>
  170.         <p>
  171.             The /p flag tells VirtualDub to add a batch job using the current settings and the given source and destination
  172.             filenames. The /b flag adds jobs to process an entire directory into another.
  173.         </p>
  174.         <blockquote><pre>virtualdub /s mySettings.vcf /p source.avi dest.avi /x</pre></blockquote>
  175.         <p>
  176.             /r causes VirtualDub to process the job queue; /c tells VirtualDub to clear it.
  177.         </p>
  178.         <blockquote><pre>virtualdub /s mySettings.vcf /c /b source dest /r /x</pre></blockquote>
  179.         <p>
  180.             /i invokes a script with arguments. All arguments following the script filename until the next switch are
  181.             passed to the script in the <tt>VirtualDub.params[]</tt> array.
  182.         </p>
  183.         <blockquote><pre>virtualdub /i process.script from.avi to.avi /x</pre></blockquote>
  184.         <p>
  185.             Finally, the <tt>/queryVersion</tt> flag causes VirtualDub to exit with its build number as the return code.
  186.             This can be used to programmatically adapt to multiple versions.
  187.         </p>
  188.         <blockquote><pre>virtualdub /queryVersion</pre></blockquote>
  189.         <p>
  190.             For the full list of supported command-line switches, run <tt>virtualdub /?</tt>.
  191.         </p>
  192.         
  193.         <h2>Invoking VirtualDub</h2>
  194.         <p>
  195.             The <tt>start</tt> command can be used to launch VirtualDub with lower
  196.             priority than usual for background operation.
  197.         </p>
  198.         <blockquote><pre>start /low virtualdub.exe</pre></blockquote>
  199.         <p>
  200.             Because <tt>virtualdub.exe</tt> and <tt>veedub64.exe</tt> are GUI programs, the command interpreter in Windows
  201.             will not wait for them to exit before returning. In addition, its main window will appear as usual. This can
  202.             be changed by using the <tt>vdub.exe</tt> or <tt>vdub64.exe</tt> front ends, which launch the main application
  203.             in a special command-line mode.
  204.         </p>
  205.         <blockquote><pre>vdub /i GetVideoLength.script foo.avi</pre></blockquote>
  206.         <p>
  207.             When the command line front end is used, VirtualDub automatically starts with its main window minimized (but not
  208.             hidden), and automatically exits when it has completed processing (implicit /x). In addition, log output is
  209.             diverted to standard output.
  210.         </p>
  211.         
  212.     </lina:create>
  213.  
  214.     <lina:create file="amd64.html" title="AMD64 version">
  215.         <p>
  216.             VirtualDub comes in two versions, the regular 32-bit x86 version, and a 64-bit version for processors that support
  217.             the AMD64 architecture. The AMD64 version has some differences from the 32-bit version.
  218.         </p>
  219.         <p>
  220.             There is currently no version for the 64-bit Intel Itanium architecture.
  221.         </p>
  222.         <h2>System requirements of VirtualDub for AMD64</h2>
  223.         <p>
  224.             In addition to the regular system requirements, the AMD64 version of VirtualDub also requires:
  225.         </p>
  226.         <ul>
  227.             <li>A CPU that supports executing AMD64 code. As of this writing, this includes the AMD Athlon 64, AMD Opteron, and
  228.                 Intel Xeons with EM64T.</li>
  229.             <li>Windows XP x64 Edition, Vista x64 Edition, or another version of Windows which natively runs in AMD64 long mode.</li>
  230.         </ul>
  231.         <p>
  232.             It is not possible to run the AMD64 version of VirtualDub on a 32-bit version of Windows even if the CPU is
  233.             64-bit capable.
  234.         </p>
  235.         <h2>Differences between the x86 and AMD64 versions</h2>
  236.         <p>
  237.             Not all functionality has been ported to 64-bit, so the selection of video filters is reduced compared to the
  238.             32-bit version. In addition, some functionality which is supported is not fully optimized compared to the 32-bit
  239.             equivalent, so the 64-bit version may or may not be faster than the 32-bit version for your scenario.
  240.         </p>
  241.         <p>
  242.             Due to an OS limitation, 64-bit programs cannot load 32-bit DLLs, and vice-versa. As a result, use of the 64-bit version
  243.             of VirtualDub requires 64-bit video codecs and 64-bit video filters; 32-bit video codecs will not show up in the video
  244.             codec list or be available for opening AVI files, and 32-bit video filters will not load. In addition, AVIFile drivers must
  245.             be 64-bit to be used on load; in particular, VirtualDub for AMD64 cannot be used with the regular 32-bit version of Avisynth.
  246.         </p>
  247.     </lina:create>
  248. </root>
  249.